home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 013a / pc2ps11.zip / PC2PS.DOC < prev    next >
Text File  |  1991-05-17  |  5KB  |  121 lines
  1. So, You replaced Your old dot-matrix-printer with a brand new
  2. PostScript laserprinter, everything seemed fine until You wanted
  3. to print an ASCII file. Up to now You just typed PRINT filename,
  4. or maybe COPY filename LPT?: (Your favorite printerport goes here),
  5. and out it came, Brrepeti BREEP Tick Tick. But these times are over!
  6. Now You need sophisticated Wordprocessors or DTP-programs with
  7. special drivers to get any output from Your printer. And loading
  8. these programs often takes longer than printing the text.
  9.  
  10. Don't despair!
  11.  
  12. Here comes... 
  13.                              PC2PS,
  14.  
  15. a simple ASCII to PostScript converter that even knows extended
  16. and linedrawing characters. And it's free!!
  17.  
  18. #include <Standard.Disclaimer>
  19.  
  20.  
  21. USAGE
  22.    pc2ps  [-r[angle]]  [-s[pointsize]]  
  23.           [-h[space]]  [-p[linepitch]]  [-o[offset]]
  24.           [-oe[offset]]  [-m[topmargin]] [-w[linewidth]] 
  25.           [-l[pagelength]]  [-i]  [-?]  [files...]
  26.    > LPT?: 
  27.  
  28. DESCRIPTION
  29.    PC2ps reads text from file(s) (or standard input if specified)
  30.    and produces postscript output on stdout, suitable for piping
  31.    to any postscript device (such as an Apple Laserwriter) or for 
  32.    using with any program that expects postscript input (such as a
  33.    postscript interpreter used to drive some other raster
  34.    device). Text is normally aligned to the top and left edges
  35.    of the imageable region of the page (usually slightly smaller
  36.    than the physical page size), and a new page is started
  37.    whenever text would fall below this region.  The following
  38.    options are understood, with all values able to be given
  39.    as integer or real:
  40.  
  41.    -r[angle]
  42.         Rotate the page by the given angle (in degrees).  The
  43.         default angle is 0 (portrait mode).  If -r is used
  44.         without specifying an angle, angle is set to 90
  45.         (landscape mode).  Angles other than 0 or 90 may cause
  46.         text to fall outside the imageable region.
  47.  
  48.    -s[pointsize]
  49.         Set the pointsize (character size) to the given value (72
  50.         points = 1 inch).  The default pointsize is 10.  If -s is
  51.         used without specifying the pointsize, the pointsize is
  52.         set to 12.
  53.  
  54.    -h[space]
  55.         Increase the horizontal spacing of characters by the
  56.         given fraction of the current pointsize.  For example,
  57.         using `-h0.25' when pointsize = 12 causes the horizontal
  58.         spacing to increase by 3 points. The default horizontal
  59.         spacing is 0 i.e. the characters are placed next to each
  60.         other, using their natural widths.  If -h is used without
  61.         specifying spacing, spacing is set to 0.25 x pointsize.
  62.  
  63.    -p[linepitch]
  64.         Set the line spacing of printed text to the given value
  65.         (72 points = 1 inch).  Unless a value is specified for
  66.         the linepitch using this option, the linepitch used will
  67.         be equal to pointsize + 2. 
  68.  
  69.    -o[offset]
  70.         Offset text from the left edge of the imageable region,
  71.         by the given distance (in centimeters) on all pages.  The
  72.         default offset is 0.  If -o is used without specifying an
  73.         offset, offset is set to 1 cm. 
  74.  
  75.    -oe[offset]
  76.         Offset text from the left edge of the imageable region,
  77.         by the given distance (in centimeters) on even pages
  78.         only.  The default offset for even pages is the same as
  79.         that for odd pages.  If -oe is used without specifying an
  80.         offset, offset is set to 1 cm on even pages.  Option -o
  81.         followed by the option -oe may be used to set offsets on
  82.         odd and even pages independently.
  83.  
  84.    -m[topmargin]
  85.         Set the top margin to the given value (in centimeters).
  86.         The default is to set this to 0.5 cm.  If -m is specified
  87.         without a value for top margin, top margin is set to 1.5
  88.         cm.
  89.  
  90.    -w[linewidth]
  91.         Specify the number of characters per line.  Longer lines
  92.         are folded.  The default is no folding.  If -w is used
  93.         without specifying linewidth, linewidth is set to 72
  94.         characters per line.  Useful with fixed-width fonts.
  95.  
  96.    -l[pagelength]
  97.         Specify the number of lines per page.  The default is to
  98.         start a new page whenever text falls below the imageable
  99.         region.  If -l is used without specifying a pagelength,
  100.         pagelength is set to 60. 
  101.  
  102.    -i   
  103.         Accept input from Stdio.
  104.  
  105.    -?
  106.         Print a list of options and quit.
  107.  
  108.    The default values (no options) give a layout that is equivalent 
  109.    to a normal lineprinter printout. Useful for listings etc.
  110.    Options without parameters give a much prettier layout (larger font,
  111.    better margins). Useful for manuals etc.
  112.    
  113. AUTHOR
  114.    This program is based on TEXT2PS by Stephen Frede (get this one,
  115.    too!!).
  116.    The Pcfont was handcrafted by Roland Giersig.
  117.    If you like the program, drop me a line at GIERSIG@EDVZ.ATI.ADA.AT
  118.  
  119. Share and Enjoy!
  120.  
  121.